結果通知 仕様
リクエスト/レスポンス
リクエスト(当サービス⇒加盟店様)
HTTP仕様
Request header |
Content-Type: application/x-www-form-urlencoded |
|
---|---|---|
Method | POST | |
文字コード | UTF-8 |
通知内容
結果通知の内容は各決済手段の「結果通知」ページを参照ください。Webドキュメント上に該当の決済手段のメニューが無い場合は結果通知プログラム(インタフェース仕様)を参照ください。
レスポンス(加盟店様⇒当サービス)
結果通知の受信成否により、以下の通りレスポンスボディを返却してください。受信成否 | レスポンスボディ | 備考 |
---|---|---|
受信成功 | 0 | |
受信失敗 | 1 |
受信失敗となり、再送処理の対象となるのは以下のケースです。 ・応答が0以外の場合 (※htmlタグ、改行コードなど、0以外の文字が含まれる場合も 受信失敗とみなします。) ・通知から10秒以内に応答が無い場合 |
再送処理
受信失敗とみなされた結果通知は所定時間後に再送されます。再送の仕様は以下の通りです。
再送回数 | 再送間隔 | 備考 |
---|---|---|
5回 | 60分(初期値) |
再送間隔は管理画面のリトライ間隔設定より、規定のパターンで変更が可能です。 検証環境では約10分間隔で再送されます。 |
再送パターン例(再送間隔60分の場合)
3回目で正常応答返却の場合送信タイミング | 応答 |
---|---|
初回(決済とほぼ同時) | 異常応答(1)、または無応答、エラー発生 |
2回目(初回より約60分後) | 異常応答(1)、または無応答、エラー発生 |
3回目(2回目より約60分後) | 正常応答(0) |
通知が全て失敗した場合
送信タイミング | 応答 |
---|---|
初回(決済とほぼ同時) | 異常応答(1)、または無応答、エラー発生 |
2回目(初回より約60分後) | 異常応答(1)、または無応答、エラー発生 |
3回目(2回目より約60分後) | 異常応答(1)、または無応答、エラー発生 |
4回目(3回目より約60分後) | 異常応答(1)、または無応答、エラー発生 |
5回目(4回目より約60分後) | 異常応答(1)、または無応答、エラー発生 |
6回目(5回目より約60分後) | 異常応答(1)、または無応答、エラー発生 |
- | - |
エラーレポート
結果通知にて加盟店様より正常応答が返却されなかった場合にメールにて通知します。
ご利用の際は管理画面より「結果通知失敗連絡先メールアドレス」の設定が必要です。
管理画面の操作方法は管理画面操作マニュアルを参照ください。
メール通知の対象となるケース
初回の結果通知に失敗した場合
※再送にて結果通知に失敗した場合はメール通知いたしません。
メール送信内容
エラーレポートメールのサンプルです。
※メール上の「現状態」は通知失敗時の取引状態です。
通知エラーパターン
エラー原因パターンを記載します。確認後に対応してください。
該当するパターンが存在しない場合は弊社までご連絡ください。
エラー内容 | 対応 |
---|---|
異常応答が返却されました。 応答[0] | 加盟店様からの応答に改行が含まれている場合に、発生します。 (エラー内容の閉じ括弧が1つ足りません)応答値に改行が含まれていないか確認してください。 |
異常応答が返却されました。 応答[1] | 加盟店様からの応答が「1:受信失敗」場合に、発生します。応答値を確認してください。 |
異常応答が返却されました。 応答[] 異常応答が返却されました。 応答[null] 異常応答が返却されました。 応答[XXXXXX(上記以外の文字列)] |
加盟店様からの応答が正常(0:受信OK/1:受信失敗)でない場合に、発生します。応答値を確認してください。 返却値については、以下のいずれかを指定してください。 0:受信OK / 1:受信失敗 |
送信に失敗しました。 発生例外[java.io.FileNotFoundException] 送信に失敗しました。 発生例外[java.net.UnknownHostException] 送信に失敗しました。 発生例外[org.apache.http.conn.HttpHostConnectException] |
加盟店様から結果通知先URLにアクセスした際に発生したエラーですが、 原因の詳細については当サービスで把握することは困難です。(結果通知先URLが存在しない場合も本エラーとなります。) |
タイムアウトが発生しました | 当サービスから結果通知先URLにアクセスしたが、接続できずにタイムアウトした場合に発生します。 該当時間帯につながりにくい状態が発生していなかったか確認ください。 |
送信に失敗しました。 発生例外[javax.net.ssl.SSLHandshakeException] 送信に失敗しました。 発生例外[javax.net.ssl.SSLHandshakeException] |
決済結果をhttps通信にて受取る場合は第三者が発行したSSLサーバ証明書が必要です。 なお、当サービスで動作確認済みの電子証明書はこちらを参照ください。 |
送信に失敗しました。 発生例外[java.net.ConnectException] 送信に失敗しました。 発生例外[java.io.IOException] |
該当のURLについて、以下をご確認ください。 ・サーバーが稼動しているか。 ・アクセス制限やBasic認証(基本認証)がかかっていないか。(80/443のデフォルトポートのみ、アクセスを許可しています。) |
結果通知一時停止について
10秒以内に応答がない結果通知が多数発生した場合、結果通知の送信を一時停止することがあります。
一定時間経過後、リトライを行い10秒以外に応答があることを確認できたら、結果通知の送信を再開します。
停止時間中に発生した取引の結果通知は、再開後にまとめて送信されます。
結果通知一時停止時/再開時は、下記のようなメールを即時に加盟店様にお送りします。
結果通知一時停止時
結果通知再開時
関連機能
管理画面から、様々な関連機能をご利用いただくことができます。